🌎 rns.kin.earth git 🌍
Commit ce9071e2d3aa3591dafa801efd12b646bc64581c
Parents : d6cf59d
Author : Mark Qvist <bc7291552be7a58f361522990465165c>
Date : 2026-05-21T17:06:04+02:00
Added ability to use wildcards in artifact fetch specifications
Changes
2 files changed, 41 insertions(+), 4 deletions(-)
Diff
diff --git a/RNS/Utilities/rngit/server.py b/RNS/Utilities/rngit/server.py
index 22daa135..4165d451 100644
--- a/RNS/Utilities/rngit/server.py
+++ b/RNS/Utilities/rngit/server.py
@@ -33,6 +33,7 @@ import os
import sys
import time
import shutil
+import fnmatch
import argparse
import threading
import subprocess
@@ -947,14 +948,14 @@ class ReticulumGitClient():
manifest_out = os.path.basename(f"{release_name}_{release_version}.{self.MSG_EXT}")
with open(manifest_out, "wb") as fh: fh.write(rsg)
+ def match_artifacts(match_expression, manifest_artifacts):
+ return [entry for entry in manifest_artifacts if fnmatch.fnmatch(entry.get("name", ""), match_expression)]
+
fetch_artifacts = []
artifacts = release_meta.get("artifacts", [])
if not artifacts: self.abort("Release manifest contains no artifacts")
if artifact == "all": fetch_artifacts = artifacts
- else:
- for entry in artifacts:
- if entry["name"] == artifact:
- fetch_artifacts = [entry]; break
+ else: fetch_artifacts = match_artifacts(artifact, artifacts)
valid_count = 0
if not fetch_artifacts: self.abort("No available artifacts specified for fetch")
diff --git a/docs/source/git.rst b/docs/source/git.rst
index 43e5c8d2..0fe73ca3 100644
--- a/docs/source/git.rst
+++ b/docs/source/git.rst
@@ -817,6 +817,42 @@ You can fetch individual artifacts from a release by specifying the artifact nam
This downloads only the specified artifact and verifies its signature against the manifest. If a file already exists locally, ``rngit`` verifies it against the manifest signature and skips the download if valid, making it safe to run the command multiple times. When fetching releases, ``rngit release`` will only download files that are missing or invalid according to the manifest. This means that partially completed release fetches can be continued later, if interrupted.
+**Pattern Matching for Artifacts**
+
+When fetching selective artifacts, you are not limited to exact names or the ``all`` keyword. You can use shell-style wildcard patterns to match multiple artifacts flexibly. This is particularly useful for selecting platform-specific builds, version ranges, or file types without specifying each file individually.
+
+.. tip::
+ When using pattern matching, make sure to enclose the target specification in quotes. Otherwise,
+ your shell will probably interpret it as a shell expansion pattern *before* it is passed as an
+ argument to ``rngit``!
+
+The pattern matching supports standard Unix wildcards:
+
+- ``*`` matches any sequence of characters (including empty)
+- ``?`` matches any single character
+- ``[seq]`` matches any character in *seq* (for example ``[0-9]`` or ``[abc]``)
+- ``[!seq]`` matches any character not in *seq*
+
+For example, to fetch all wheel files for Python 3 across any platform:
+
+.. code:: text
+
+ $ rngit release rns://remote_node/public/myrepo fetch "1.2.0:*-py3-*.whl"
+
+To fetch a specific patch version when you know the major and minor version:
+
+.. code:: text
+
+ $ rngit release rns://remote_node/public/myrepo fetch "1.2.0:myapp-1.2.?-linux-x86_64.tar.gz"
+
+Or to retrieve all source archives:
+
+.. code:: text
+
+ $ rngit release rns://remote_node/public/myrepo fetch "1.2.0:source_*.tgz"
+
+If your pattern contains no wildcard characters, it must match an artifact name exactly, which is useful for fetching single, specific artifacts. When a pattern matches multiple artifacts, all matched files are fetched and verified. If no artifacts match the pattern, the fetch aborts with an error indicating no matches were found.
+
**Offline Verification**
Because the release manifest contains embedded signatures, you can verify the integrity of release artifacts offline, without connecting to the repository node. The ``rnid`` and ``rngit`` utilities can validate artifact signatures against ``.rsg`` and manifest files.
Served by rngit 1.5.0 - Generated in 0.06s